home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / srdemo / srdemo.txt < prev    next >
Text File  |  1995-08-26  |  12KB  |  361 lines
  1.  
  2.  
  3.  
  4.  
  5.                                   SRDEMO 1.1
  6.                     LIB DEMO: Alphanumeric Filename Sorting
  7.                    Copyright (c) 1995 by David M. Wincelberg
  8.  
  9.  
  10.                                Table of Contents
  11.  
  12.        I.    Introduction ...........................................  1
  13.        II.   How to Use .............................................  2
  14.  
  15.        Appendices:
  16.  
  17.        A.    Command Line Parameters and Switches ...................  2
  18.        B.    Other FileJockey Software Products .....................  3
  19.        C.    License Agreement ......................................  5
  20.  
  21.  
  22.        I.    Introduction
  23.  
  24.        Thank you for trying SRDEMO.  It demonstrates library routines
  25.        (SRLIB) to sort long or short file names that may contain digits,
  26.        spaces, lower-case letters and/or commas within numbers.  For
  27.        example, SRLIB places FILE_2 before FILE_10.  It is compiled for
  28.        Microsoft C 6.0, C 7.0, VC++ 1.x and Borland TC++ 4.5 for the
  29.        small and large memory models.
  30.  
  31.             To assist you in testing SRLIB, included in SRDEMO.ZIP are
  32.        list files LISTFILE and LISTFILE.W95.  The latter file contains
  33.        long file names with embedded spaces and commas to simulate
  34.        Windows 95 long file names.  SRDEMO can read these files and sort
  35.        the names in them in addition to or instead of reading file names
  36.        from a directory.  Alternatively, you could use ZOPEN and ZDEL to
  37.        create and delete zero-size files.  ZOPEN can create files from
  38.        listfiles containing file names that do not exceed the short
  39.        ("8.3") DOS limit.
  40.  
  41.             SRDEMO is not limited to sorting a preset number of files.
  42.        In addition, it does not read the selected directory twice --
  43.        once to count the number of files and once to store them in
  44.        array.  Instead, it uses a fast approach which is documented in
  45.        SRLIB.TXT.  Its source code is included in SRLIB.ZIP.
  46.  
  47.             If you decide to license SRLIB, you can either GO SWREG
  48.        (#5947) on CompuServe or use the included order form.  A site-
  49.        license/source-code option is also on the order form.  SRDEMO is
  50.        a free program that is safe to run on a Pentium processor since
  51.        it does not perform any floating point divisions of large
  52.        numbers.  It requires DOS 2.1 or higher.
  53.             
  54.             Please send comments, suggestions and problem reports to me
  55.        at 71573,1023 by CompuServe e-mail, at 71573.1023@compuserve.com
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.        by Internet e-mail, or at my postal address, even if you are not
  66.        currently a customer.
  67.  
  68.  
  69.        II.   How to Use
  70.  
  71.        Enter
  72.  
  73.                             SRDEMO @LISTFILE /W4 /I
  74.  
  75.        to produce the listing in README.TXT.  Then enter
  76.  
  77.                        SRDEMO @LISTFILE.W95 /W4 /I /C /A
  78.  
  79.        to sort a set of long file names without regard to case, commas
  80.        or spaces.  The switch /W4 produces a wide display of no more
  81.        than four file names per line, /I selects ignoring case, /C picks
  82.        ignoring commas and /A chooses ignoring spaces.  See Appendix A
  83.        for a complete list of the command-line switches.  To create
  84.        another list file, use a text editor to place one file name at
  85.        the beginning of each line.  Don't worry about blank lines.
  86.        SRDEMO ignores them.
  87.  
  88.             Alternatively, you may use ZOPEN and ZDEL to create and
  89.        delete zero-size files with short names.  SRDEMO can sort a
  90.        mixture of names read from directories and list files.
  91.  
  92.  
  93.        Appendices
  94.  
  95.        A.    Command Line Parameters and Switches
  96.  
  97.        A.1.  SRDEMO: Demonstrates Alphanumeric Filename Sorting
  98.  
  99.        Entering
  100.                                    SRDEMO /?
  101.  
  102.        produces the following summary of command line parameters and
  103.        switches:
  104.  
  105.        SRDEMO [switches] [pattern ...] [@listfile ...]
  106.  
  107.        pattern        Filename pattern (default is *.* if no listfile)
  108.        listfile       File containing names to simulate
  109.        /I             Use case-insensitive comparisons
  110.        /A             Ignore all spaces (outside of numbers)
  111.        /M             Ignore multiple spaces (outside of numbers)
  112.        /C             Ignore commas in numbers
  113.        /P             Pause after each screen of information
  114.        /W             Use wide display -- 5 names per line
  115.        /W4            Use wide display -- 4 names per line
  116.  
  117.  
  118.  
  119.                                     Page 2
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.        The names in a listfile can be up to 78 characters long.  The /W4
  127.        switch produces a display that can be included in a memo without
  128.        re-formatting.
  129.  
  130.  
  131.        A.2.  ZOPEN: Creates a single or set of zero-size files
  132.  
  133.        Entering
  134.                                    ZOPEN /?
  135.  
  136.        produces the following summary of command line parameters:
  137.  
  138.        ZOPEN { filename | @listfile }
  139.  
  140.        filename       A single file name
  141.        listfile       Name of a file containing a list of files to
  142.                       create, one file name per line
  143.  
  144.        The braces and vertical bar (|) mean that you must choose to
  145.        create either a single short file name or tell the program where
  146.        to find a list of short file names.  Note that you must precede
  147.        the list-file name with the at-sign (@).
  148.  
  149.  
  150.        A.3.  ZDEL: Deletes zero-size files
  151.  
  152.        Entering
  153.                                     ZDEL /?
  154.  
  155.        produces the following summary of command line parameters:
  156.  
  157.        ZDEL [drive:][directory]pattern
  158.  
  159.        pattern        A file name or a wildcard pattern
  160.  
  161.        This parameter is self-explanatory.
  162.  
  163.  
  164.        B.    Other FileJockey Software Products
  165.  
  166.        Following is a list of current FileJockey Software products.  All
  167.        of the compressed files for these products have extension ZIP.
  168.        In parentheses after the descriptions are the locations where the
  169.        programs may be found on CompuServe and the registration/license
  170.        fees.
  171.  
  172.  
  173.        B.1.  System Tools
  174.  
  175.        WRDGRB 1.1 -- Copies Words From DOS Screen to Command Line:
  176.  
  177.  
  178.  
  179.                                     Page 3
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.        No more typing words you see on the DOS screen!  With WRDGRB
  187.        installed, you simply press the hot-key sequence, highlight text
  188.        with your mouse, and left click to copy it to the command line
  189.        (or right click to cancel).  WRDGRB even connects a filename to
  190.        its extension when both are highlighted in a directory listing.
  191.        New: smaller by 19K, a default-values file, and more.  23K TSR.
  192.        No known bugs.  GO SWREG (#5571) to register on-line.  (GO
  193.        PCUTIL, Library 3, $35)
  194.  
  195.  
  196.        LISTRS 1.2 -- Directory/Program List Makers With Action Options:
  197.  
  198.        DIRLIST: More accurate than "dir *."  Options include show files,
  199.        change to and remove directory.  PROGLIST: Shows current
  200.        directory's .EXE, .COM and .BAT files in one listing to help
  201.        users find the name of the program file to run.  Options include
  202.        type & run, type & wait and edit .BAT files with a user-selected
  203.        editor.  Both programs correctly sort numbers within filenames.
  204.        No known bugs.  (GO PCUTIL, Library 5, $15)
  205.  
  206.  
  207.        B.2.  Programmer Tool
  208.  
  209.        PROGCR 1.0 -- Prepares Programs for Copyrighting:
  210.  
  211.        Protects the privacy of your C/C++ or PASCAL source code
  212.        copyright deposit by removing comments after each file's header
  213.        (which should primarily consist of your copyright notice) from
  214.        copies of the original files.  Also, copies words displayed by
  215.        standard or user-specified print commands to a file for spell
  216.        checking.  (GO PCPROG, Library 6, $10)
  217.  
  218.  
  219.        B.3.  BBS-Session Tools
  220.  
  221.        CFWRAP 1.1 -- Word Wrapping Tuned for BBS Capture Files:
  222.  
  223.        Prepares BBS capture files for editing by removing page pause
  224.        lines ("Press <CR> for more !", etc.) and word-wrapping various
  225.        types of paragraphs (including each line starting with ">>" and